AWeb-ARexx-Befehle

Abfrage-Befehle

GET (allgemein)
GET ACTIVEPORT
GET CACHE
GET FOCUS
GET FRAMES

GET HOTLIST
GET IMAGES
GET INFO
GET LINKS
GET MIME

GET NAMES
GET PORT
GET SCREEN
GET SELECTION
GET SOURCE

GET TITLE
GET URL
GET VERSION
GET WINDOW
GET WINDOWS

GET

Schablone:


   GET ITEM/A,TARGET/K,VAR/K,STEM/K,ALL/S

Holt verschiedene Arten von Informationen über das Programm oder das Dokument im angesprochenen Fenster oder Frame.

Argument Beschreibung
ITEM Legt die Art der gewünschten Information fest. In der oben aufgeführten Liste sind alle gültigen Item-Namen angegeben.
TARGET Der Zielname des Fensters oder Frames, von dem Informationen abgefragt werden.
VAR Name der Variablen, in die die erhaltene Information eingegeben werden soll. Wenn kein Name angegeben ist, wird das Ergebnis in die reservierte ARexx-Variable RESULT eingegeben.
STEM Name einer Stamm-Variablen, in die ein Array mit strukturierten Informationen eingegeben werden sollen. Benutzen Sie in diesem Namen keine Trennpunkte.
ALL Die Bedeutung dieses Schalters hängt vom gewählten ITEM-Typ ab.
Nicht alle der hier aufgeführten Argumente können in allen ITEM-Typem benutzt werden. Sehen Sie unten in den genauen Beschreibungen nach, deren Schablonen alle gültigen Argumente enthalten.

Argument	Beschreibung
ITEM	Legt die Art der gewünschten Information fest. In der oben aufgeführten Liste sind alle gültigen Item-Namen angegeben.
TARGET	Der Zielname des Fensters oder Frames, von dem Informationen abgefragt werden.
VAR	Name der Variablen, in die die erhaltene Information eingegeben werden soll. Wenn kein Name angegeben ist, wird das Ergebnis in die reservierte ARexx-Variable `RESULT` eingegeben.
STEM	Name einer Stamm-Variablen, in die ein Array mit strukturierten Informationen eingegeben werden sollen. Benutzen Sie in diesem Namen keine Trennpunkte.
ALL	Die Bedeutung dieses Schalters hängt vom gewählten ITEM-Typ ab.

GET ACTIVEPORT

Schablone:


   GET ACTIVEPORT  VAR/K

Holt den Namen des ARexx-Ports, der dem zuletzt geöffneten AWeb-Fenster zugeordnet ist. Nützlich in ARexx-Makros, die über ein Shell-Skript oder einen Shell-Befehl gestartet werden, um das aktive Fenster zu finden.

GET CACHE

Schablone:


   GET CACHE  STEM/K

Fragt Einzelheiten zu den Dateien ab, die sich im AWeb-Puffer befinden.

Bestandteile der strukturierten Informationen
Name Beschreibung
URL Die URL der gepufferten Datei.
TYPE Der MIME-Typ der gepufferten Datei.
SIZE Die Größe der gepufferten Datei in Bytes.
DATE Das Datum, an dem die Datei gespeichert wurde, in internen Systemtagen (wie sie vom DATE('I')-Befehl zurückgegeben werden).
FILE Voller Pfad- und Dateiname der gepufferten Kopie.
WICHTIG: Benutzen Sie zum Löschen oder Ändern dieser Dateien nur die AWeb-ARexx-Befehle!

Bestandteile der strukturierten Informationen
Name	Beschreibung
URL	Die URL der gepufferten Datei.
TYPE	Der MIME-Typ der gepufferten Datei.
SIZE	Die Größe der gepufferten Datei in Bytes.
DATE	Das Datum, an dem die Datei gespeichert wurde, in internen Systemtagen (wie sie vom `DATE('I')`-Befehl zurückgegeben werden).
FILE	Voller Pfad- und Dateiname der gepufferten Kopie. WICHTIG: Benutzen Sie zum Löschen oder Ändern dieser Dateien nur die AWeb-ARexx-Befehle!

GET FOCUS

Schablone:


   GET FOCUS  VAR/K

Fragt die ID des Frames ab, für den gerade die Scroll-Funktion über die Taststur gesteuert werden kann. Wenn das das Hauptfenster sein sollte, wird eine leere Zeichenkette zurückgegeben.

GET FRAMES

Schablone:


   GET FRAMES  TARGET/K,STEM/A/K,ALL/S

Holt ein Array von Namen und IDs aller Frames, die dem Zielfenster oder -frame des Befehls untergeordnet sind. Wenn der Schalter ALL gesetzt wird, werden auch Einzelheiten aller verschachtelten Frames zurückgegeben.

Bestandteile der strukturierten Informationen
Name Beschreibung
ID Eine einmalige Identifizierung des Frames (innerhalb des angesprochenen Fensters). Frames haben nicht unbedingt einen Namen, aber immer eine ID. Die ID beginnt mit dem Zeichen #. Sie kann in TARGET-ARexx-Befehlen benutzt werden.
Beachten Sie aber, daß diese ID nicht in HTML-TARGET-Attributen verwendet werden kann.
NAME Name des Frames, wie er im NAME-Attribut im <FRAME>-HTML-Tag definiert ist.
TITLE Der Titel des im Frame geladenen Dokuments. Wenn das Dokument keinen definierten Titel hat, wird die URL des Dokumentes zurückgegeben.
URL Die URL des im Frame geladenen Dokuments.

Bestandteile der strukturierten Informationen
Name	Beschreibung
ID	Eine einmalige Identifizierung des Frames (innerhalb des angesprochenen Fensters). Frames haben nicht unbedingt einen Namen, aber immer eine ID. Die ID beginnt mit dem Zeichen `#`. Sie kann in `TARGET`-ARexx-Befehlen benutzt werden. Beachten Sie aber, daß diese ID nicht in HTML-`TARGET`-Attributen verwendet werden kann.
NAME	Name des Frames, wie er im NAME-Attribut im <FRAME>-HTML-Tag definiert ist.
TITLE	Der Titel des im Frame geladenen Dokuments. Wenn das Dokument keinen definierten Titel hat, wird die URL des Dokumentes zurückgegeben.
URL	Die URL des im Frame geladenen Dokuments.

GET HOTLIST

Schablone:


   GET HOTLIST  STEM/A/K

Fragt ein Array von allen Einträgen der AWeb-Hotlist ab.

Bestandteile der strukturierten Informationen
Name Beschreibung
GROUP "1", wenn das Element der Reihe eine Gruppe definiert, oder "0", wenn es einen Einzeleintrag definiert.
TITLE Titel der Gruppe oder des Eintrags, wie er in der Hotlist angegeben ist.
URL URL des Eintrags. Nur definiert für Einzeleinträge, nicht für Gruppen.
OWNER Die Index-Nummer der Gruppe, der das Reihenelement angehört. Dieser Wert ist 0, wenn es keiner Gruppe angehört (d.h. es ist eine Gruppe der obersten Ebene oder ein keiner Gruppe zugewiesener Einzeleintrag).

Bestandteile der strukturierten Informationen
Name	Beschreibung
GROUP	"1", wenn das Element der Reihe eine Gruppe definiert, oder "0", wenn es einen Einzeleintrag definiert.
TITLE	Titel der Gruppe oder des Eintrags, wie er in der Hotlist angegeben ist.
URL	URL des Eintrags. Nur definiert für Einzeleinträge, nicht für Gruppen.
OWNER	Die Index-Nummer der Gruppe, der das Reihenelement angehört. Dieser Wert ist 0, wenn es keiner Gruppe angehört (d.h. es ist eine Gruppe der obersten Ebene oder ein keiner Gruppe zugewiesener Einzeleintrag).

GET IMAGES

Schablone:


   GET IMAGES  TARGET/K,STEM/A/K

Holt eine Liste mit Informationen über alle eingebundenen Bilder im HTML-Dokument, das im angesprochenen Fenster oder Frame angezeigt wird.

Bestandteile der strukturierten Informationen
Name Beschreibung
ALT Der ALT-Text zu diesem Bild, falls vorhanden.
TYPE Der Typ des Bildes. Das ist einer der folgenden:

BACKGROUND Das Hintergrundbild des Dokuments.
IMAGE Keines der anderen speziellen Bilder.
ISMAP Eine Image-Map des Servers.
USEMAP Eine Image-Map des Clients.

URL Die URL des Bildes.

GET INFO

Schablone:


   GET INFO  TARGET/K,STEM/A/K

Holt HTTP-Adressen sowie <META>- und <LINK>-Informationen des angesprochenen Fensters oder Frames.

Bestandteile der strukturierten Informationen
Name Beschreibung
TYPE Typ der Information. Das ist einer der folgenden:

CACHE Das Dokument wurde aus dem AWeb-Puffer gelesen. Der VALUE-Bestandteil enthält eine "1".
HTTP HTTP-Transfer-Header.
META HTML-<META>-Information.
LINK Ein HTML-<LINK>-Verweis.

VALUE Abhängig vom zurückgegebenen TYPE: der HTTP-Header, der META-Name und Inhalt, oder der LINK-Titel.
URL Die zugehörige URL. Nur möglich, wenn TYPE "LINK" entspricht.

GET LINKS

Schablone:


   GET LINKS  TARGET/K,STEM/A/K

Holt ein Array von Informationen zu allen Hyperlinks des im angesprochenen Fenster oder Frame dargestellten HTML-Dokuments.

Bestandteile der strukturierten Informationen
Name Beschreibung
TARGET Der Name des Zielframes, wie im HTML-Attribut TARGET definiert.
URL Die URL, auf die dieser Link verweist.

Bestandteile der strukturierten Informationen
Name	Beschreibung
TARGET	Der Name des Zielframes, wie im HTML-Attribut `TARGET` definiert.
URL	Die URL, auf die dieser Link verweist.

GET MIME

Schablone:


   GET MIME  TARGET/K,VAR/K

Holt den MIME-Typ des im angesprochenen Fenster oder Frame dargestellten Dokuments.

GET NAMES

Schablone:


   GET NAMES  TARGET/K,STEM/A/K

Holt ein Array mit den Namen aller Teilfragmente des im angesprochenen Fenster oder Frame dargestellten HTML-Dokuments, wie in <A NAME="name"> definiert.

Bestandteile der strukturierten Informationen
Name Beschreibung
NAME Der Name des Fragments.

Bestandteile der strukturierten Informationen
Name	Beschreibung
NAME	Der Name des Fragments.

GET PORT

Schablone:


   GET PORT  TARGET/K

Holt den Namen des ARexx-Ports des Fensters, das den Frame mit dem angegebenen Namen enthält.

GET SCREEN

Schablone:


   GET SCREEN  VAR/K

Holt den Namen des öffentlichen Bildschirms, auf dem das AWeb-Fenster geöffnet ist.

GET SELECTION

Schablone:


   GET SELECTION  VAR/K

Fragt den aktuell ausgewählten Text ab.

Beachten Sie, daß aufgrund einer Beschränkung in ARexx nur die ersten 65535 Zeichen zurückgegeben werden.

GET SOURCE

Schablone:


   GET SOURCE  TARGET/K,VAR/K

Holt den Quellcode des aktuell im angesprochenen Fenster oder Frame dargestellten Dokuments.

Beachten Sie, daß aufgrund einer Beschränkung in ARexx nur die ersten 65535 Zeichen zurückgegeben werden.

GET TITLE

Schablone:


   GET TITLE  TARGET/K,VAR/K

Fragt den Titel des Dokuments ab, das aktuell im angesprochenen Fenster oder Frame dargestellt wird. Wenn das Dokument keinen definierten Titel hat, wird die URL zurückgegeben.

GET URL

Schablone:


   GET URL  TARGET/K,VAR/K

Holt die URL des Dokuments, das aktuell im angesprochenen Fenster oder Frame dargestellt wird.

GET VERSION

Schablone:


   GET VERSION  VAR/K

Fragt die Versionsnummer von AWeb ab. Die zurückgegebene Zeichenkette beginnt mit "version.revision".

GET WINDOW

Schablone:


   GET WINDOW  VAR/K

Holt das Rechteck, das Ort und Größe des angesprochenen Fensters beschreibt.

GET WINDOWS

Schablone:


   GET WINDOWS  STEM/A/K

Holt ein Array mit Details zu allen offenen AWeb-Fenstern.

Bestandteile der strukturierten Informationen
Name Beschreibung
PORT Der Name des ARexx-Ports des Fensters.
RECT Ein Rechteck, das Ort und Größe des Fensters beschreibt.
ZOOMED Wenn das Fenster gerade vergrößert, steht hier der Wert "1", andernfalls der Wert "0".

Name	Beschreibung
PORT	Der Name des ARexx-Ports des Fensters.
RECT	Ein Rechteck, das Ort und Größe des Fensters beschreibt.
ZOOMED	Wenn das Fenster gerade vergrößert, steht hier der Wert "1", andernfalls der Wert "0".